Ab der ingenious Version 5.0 können mehrere SMTP-Konten im Programm hinterlegt werden, um unterschiedliche Absender E-Mail Adressen für unterschiedliche Anwendungen zu verwenden. So kann z.B. in einem Skript auf ein bestimmtes SMTP-Konto referenziert oder je Benutzer eine eigene Absender Adresse ausgewählt werden (vgl. Allgemeine Benutzerdaten).
Es können klassische SMTP-Konten hinterlegt werden oder Konten mit OAuth 2.0 Authentifizierung (eine Organisation).
Ein hier konfiguriertes Standard SMTP-Konto wird verwendet, wenn kein anderes Konto explizit ausgewählt wurde, und gilt vorrangig vor dem unter Netzwerk und WebServer konfigurierten SMTP-Konto (Kompatibilität zur ingenious Version 4.0).
Die folgenden Einstellungen sind hier zu treffen:
OAuth 2.0
| App ID | Einfaches Eingabefeld | Die ID der beim Anbieter registrierten Version des Ingenious Programms. |
| Tenant ID | Einfaches Eingabefeld | Die Mandanten ID der Organisation innerhalb der Cloud-Umgebung. |
| OAuth Secretkey | Maskiertes Eingabefeld + Button | Hier ist der für den Zugriff eingerichtete Secretkey zu hinterlegen. Über den Button kann das maskierte Passwort sichtbar gemacht werden. Nur Benutzer mit entsprechendem Benutzerrecht können den Secretkey einsehen. |
| Oauth RedirectURI | Einfaches Eingabefeld | URL, unter der der Authorization Code empfangen wird (Standard für Microsoft Azure: http://localhost:5000/) |
| OAuth SMTP Server | Einfaches Eingabefeld | Die Adresse des SMTP-Servers (Standard für Microsoft Azure: smtp-mail.outlook.com) |
| OAuth SMTP Port | Einfaches Eingabefeld | Hier ist der Port einzutragen, über den der Server angesprochen wird (Standard für Microsoft Azure: 587) |
Die OAuth 2.0 Konfiguration gilt für alle SMTP-Konten, für die in der Konfiguration als Versandart "OAuth 2.0" ausgewählt wurde.
Alle hinterlegten SMTP Konten werden in einer Liste dargestellt.
Ein neues SMTP-Konto wird über den Button 
hinzugefügt. Ein bestehendes SMTP-Konto kann über den Button 
entfernt werden.
Konfiguration eines SMTP-Kontos
| SMTP Versandart | Auswahlliste | Auswahl der Versandart Klassisch oder OAuth 2.0 |
| OAuth 2.0 Adresse | Einfaches Eingabefeld | Für die Versandart OAuth 2.0 ist hier die Absender E-Mail Adresse einzutragen. |
| SMTP Login | Einfaches Eingabefeld | Login Name für ein klassisches SMTP-Konto (meist die E-Mail Adresse) |
| SMTP Passwort | Maskiertes Eingabefeld + Button | Passwort für das klassische SMTP-Konto. Über den Button kann das maskierte Passwort sichtbar gemacht werden. Nur Benutzer mit entsprechendem Benutzerrecht können den Secretkey einsehen. |
| SMTP Host | Einfaches Eingabefeld | Server, der das SMTP-Konto hostet (Host-URL des Providers) |
| SMTP Sender | Einfaches Eingabefeld | Absender E-Mail Adresse des SMTP-Kontos |
| Standard | Checkbox | Mit dieser Checkbox wird ein SMTP-Konto als Standard bestimmt und wird vom Programm immer dann verwendet, wenn kein anderes Konto für einen Benutzer oder einen Prozess definiert wurde. |
| SSL / TLS | Checkbox | Ist die Checkbox aktiviert, erfolgt die Datenübertragung verschlüsselt. (Abhängig vom Provider) |
Über den Button "Test E-Mail" kann der Zugriff auf das SMTP-Konto geprüft werden.
Verwendung der SMTP-Konten
Die konfigurierten SMTP-Konten werden wie folgt verwendet:
- Für den Versand von Serienbriefen - Der Versand erfolgt immer per SMTP.
- Für den Versand von Projektdokumenten, wenn unter Druck und Versand der Versand von E-Mails über SMTP konfiguriert ist.
- Für den Versand von Mahnungen, wenn unter Druck und Versand der Versand von E-Mails über SMTP konfiguriert ist.
- Für den Versand von E-Mails per Skript
Der Versand erfolgt über das beim angemeldeten Benutzer zugewiesene SMTP-Konto (vgl. Allgemeine Benutzerdaten) oder, wenn kein Konto ausgwählt wurde, über das Standard-Konto.
Verwendung eines SMTP-Kontos in einem Skript
Mit dem folgenden Aufruf kann eine E-Mail per Skript versendet werden:
ingenious.net.Tools.Export.SendEmail.Send(recipient, subject, body, isBodyHtml, attachmentFilenames, allowPopups, bSendMAPI, emailaddress);
Die folgenden Parameter werden dabei berücksichtigt:
| Recipient(string) | E-Mail Adresse des Empfängers |
| Subject(string) | Betreff der E-Mail |
| Body(string) | Der Text der E-Mail |
| isBodyHtml(bool) | Angabe ob es sich um ein HTML Format handelt |
| attachmentFileNames (IEnumerable<string>) | Liste der Dateinamen der Anhänge |
| allowPopups(bool) | Angabe ob Pop-Ups mit eventuellen Fehlermeldungen angezeigt werden sollen |
| bSendMAPI(bool) | Angabe ob die E-Mail über MAPI versendet werden soll |
| emailaddress(string) | E-Mail Adresse des Absenders / Authentifizierungsaddresse (E-Mail Adresse des hinterlegten SMTP-Kontos) |